home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / pcbre200.zip / PCBRESET.DOC < prev    next >
Text File  |  1993-01-07  |  5KB  |  141 lines
  1. PCBRESET.DOC - PCBReset v2.00 documentation - 1/7/93
  2.  
  3.  
  4. Purpose:
  5.  
  6.          To determine if the PCBOARD.SYS file was left in its on-line
  7. state or its off-line state.
  8.  
  9.          I use this little program with my Fido front-end mailer to
  10. determine if the BBS/computer crashed on the last caller.  This is
  11. usually only caused by a power failure, but other things can cause it
  12. too.  If it did crash, the PCBOARD.SYS file will show the caller as still
  13. on-line.  Meaning, PCBoard needs to be recycled BEFORE the front-end is
  14. loaded.  Otherwise, PCBoard will let the next caller in without asking
  15. for a name and password!  It will assume that the person is the previous
  16. caller.  That can be REAL SCARY if the last caller was YOU!!  You
  17. wouldn't want someone that you didn't know fiddling around in your BBS
  18. with full Sysop access...
  19.  
  20.         This has been tested with PCBoard v14.5a, but I *think* that it
  21. will work with any 14.x version of PCBoard.
  22.  
  23.  
  24. Note: PCBoard is a registered trademark of Clark Development Company, Inc.
  25.  
  26.  
  27. Syntax:
  28.  
  29.          PCBReset PCBSysPath [CallerLogPath]
  30.  
  31.          Where:  PCBSysPath is the full path and filename of your
  32.                  PCBOARD.SYS file.  This is required.
  33.  
  34.                  CallerLogPath is the full path and filename of your
  35.                  caller log file.  This is optional.  If you include it,
  36.                  PCBReset will make a log entry of the time and date
  37.                  if it recycles the BBS.
  38.  
  39. Results:
  40.  
  41.          An errorlevel of 1 is returned if a caller is still logged in.
  42.          An errorlevel of 2 is returned if PCBOARD.SYS could not be opened.
  43.          An errorlevel of 3 is returned if PCBOARD.SYS could not be read.
  44.  
  45.  
  46. Example:
  47.  
  48.          PCBReset C:\PCB\PCBOARD.SYS C:\PCB\MAIN\CALLER
  49.  
  50.          Here is the batch file that I use in my AUTOEXEC.BAT to call
  51. up my BBS.  It is included as the file B.BAT
  52.  
  53.      G:                                    { log to the correct drive     }
  54.      CD\IM                                 { change to front-end's subdir }
  55.      PCBRESET G:\PCB\PCBOARD.SYS G:\PCB\MAIN\CALLER1     { Did it crash?  }
  56.      IF ERRORLEVEL 1 BOARD /KEY:G^M        { Yes...recycle PCBoard        }
  57.      IMRUN                                 { No...load InterMail          }
  58.  
  59.          This arrangement assumes that your BOARD.BAT file will load the
  60. front-end mailer when PCB exits.
  61.  
  62.  
  63. For you FrontDoor people, you might have to modify the B.BAT file so it
  64. looks a little like this:
  65.  
  66.      G:                                    { log to the correct drive     }
  67.      CD\FD                                 { change to front-end's subdir }
  68.      PCBRESET G:\PCB\PCBOARD.SYS G:\PCB\MAIN\CALLER1     { Did it crash?  }
  69.      IF ERRORLEVEL 1 BOARD /KEY:G^M        { Yes...recycle PCBoard        }
  70.      RUNFD                                 { No...load FrontDoor          }
  71.  
  72.  
  73. In the above examples, the /KEY:G^M will cause PCBoard to logoff the caller
  74. by typing a G and then a carriage return.  This is needed if the system
  75. crashed while someone was logged on locally.
  76.  
  77. Please note that PCBReset does not need to be called every time you load
  78. up your front-end mailer.  It only needs to be run the first time that
  79. your mailer is loaded after the computer has been started up or rebooted.
  80.  
  81.  
  82. For reference, here is what my BOARD.BAT looks like:
  83.  
  84. ECHO OFF
  85. G:
  86. CD \PCB
  87. SET PCB=/SWAP /MAIN
  88. SET DSZLOG=PCBDSZ.LOG
  89. IF EXIST REMOTE.BAT RENAME REMOTE.BAT REMOTE.SYS
  90. IF EXIST EVENT.BAT RENAME EVENT.BAT EVENT.SYS
  91. IF EXIST DOOR.BAT DEL DOOR.BAT
  92. IF EXIST ENDPCB DEL ENDPCB
  93. PCB145 %1 %2                              { make sure the %1 is there so }
  94. IF EXIST REMOTE.BAT REMOTE                { that the /KEY:G^M will work  }
  95. IF EXIST DOOR.BAT DOOR
  96. IF EXIST EVENT.BAT EVENT
  97. IF EXIST ENDPCB GOTO END
  98. BOARD
  99. :END
  100. C:
  101. cd\IM
  102. IMRUN                  { B.BAT assumes that you load your front end here }
  103.  
  104.  
  105. Disclaimer:
  106.  
  107.         No warranties are expressed or implied concerning this program.
  108. It is offered in an AS IS condition.  The author and distributors of this
  109. program are not liable for the direct or consequential loss or damages
  110. that may have resulted from its use and/or misuse.  By using this program,
  111. you agree to these terms.
  112.  
  113.  
  114. PCBReset is:  Copyright 1992-1993 Christopher E. Long, All Rights Reserved
  115.  
  116.  
  117.          This program is Freeware.  That means that I retain the rights
  118. to it, but I do not require compensation for its use.  However, I do ask
  119. that if you find it useful, send me a postcard!  That's all I ask.
  120.  
  121.  
  122. Mailing address:        Christopher E. Long
  123.                         632 Camelia Street
  124.                         Atlantic Beach, FL 32233
  125.  
  126. Internet address:       chris.long@medinfo.jax.fl.us
  127.  
  128. Compuserve address:     76500,2073
  129.  
  130. Phone (voice):          904-246-4706
  131.  
  132. Phone (data):           Visionary Endeavors BBS
  133.                         904-249-9515
  134.                         1200 - 16,800 bps
  135.                         US Robotics HST Dual Standard 16.8
  136.                         8 data bits, 1 stop bit, no parity
  137.                         FidoNet 1:112/10 file requests all hours
  138.                         located in Atlantic Beach, Florida
  139.  
  140. -END-
  141.